Resolves #369.

• Updates user interface for X accounts to add navigation to the right sidebar, including a new "Migrate to Bluesky" page
• Allow the user to connect a Bluesky account to their X account in Cyd using OAuth (and to disconnect the Bluesky account), including using cyd:// protocol links
• Add a join table migration in the X account SQLite database to track which tweets have been migrated and where
• Support basic migrating of tweets
• Support migrating complex tweets (blocked by When indexing tweets, save media, reply status, and quote status too #354):
  • Tweets with media
  • Quote tweets
  • Threads of tweets
• When building the X archive, link to Bluesky posts that have been migrated
• Make this a premium features -- and make sure the premium flow works smoothly
• Tell people they need to archive their tweets before they can migrate them
• Detect if an archive/import happened before this release, and if so tell people to import again first

Before reviewing this PR, we should review and merge #393. I've merged those commits into this branch, so merging that into main will make this branch have far fewer commits.

Here's a brief tour of this feature and the related changes in this branch. First, I'm going to start with a fresh instance of Cyd Dev by deleting the app data and deleting the data in my test account:

rm -r ~/Library/Application\ Support/Cyd\ Dev/
rm -r ~/Documents/Cyd\ Dev/X/nexamind91326/

New navigation

I open Cyd and add my test X account and login to X. The interface looks like this:

In the right sidebar of an X account, there's now nav menu with "Local Database", "Delete from X", and "Migrate to Bluesky". Before there was no nav, and you just got around via buttons in the wizard.

As part of this PR, I've also changed the messaging it shows you when you haven't imported any data yet. If you switch to Delete from X, it shows this prominent warning and encourages you to build your local database first:

A similar warning was shown before, but I think this looks better. Also on the Delete from X page, it shows the disabled options (delete my tweets, delete my retweets, delete my looks) isn't of completely hiding them.

The same warning is on the Migrate to Bluesky page:

Info/warning alerts after you have some data

Next, I built a database from scratch, and now the three pages show that last time the database was built (or imported from an archive). The Local Database page doesn't have a button:

But the Delete from X and Migrate to Bluesky pages do:

Note that it determines whether or not you have data by loading the lastFinishedJob_indexTweets, lastFinishedJob_indexLikes, and lastFinishedJob_importArchive account config settings, which store timestamps. If I go through and update the timestamps in the SQL database to be before February 18, 2025, the Migrate to Bluesky page shows you this warning:

REMINDER: Before releasing this in prod, we should update this date to be the release date. It's hardcoded in XWizardMigrateBluesky.vue.

The Cyd archive before migrating

At this point, if you browse the Cyd archive, it looks like this. It has all of the fancy stuff from #393, and there's a link to the original tweet, but there's no link to the migrated version in Bluesky yet.

Bluesky OAuth

I put my test Bluesky handle (nexamind-cyd.bsky.social) in Cyd and click Connect:

This opens a new tab in my browser to authenticate to Bluesky:

I click Accept, and it redirects to a special cyd.social URL:

I click "Open Link" and the Cyd app responds saying I'm successfully connected (note you can test canceling in the OAuth flow too, everything should be handled). Once you're connected, you can start migrating to Bluesky. It tells you the number of tweets it can migrate, the number it can't migrate because they're replies, and the number that have already been migrated:

When you click "Start Migrating to Bluesky", it verifies that you have premium access.

Premium check

This is a premium feature, so I want to make the premium flow is seamless. I had to update how the premium check works a bit from before. But basically, if you're not signed in to a Cyd account or you're signed in but haven't paid for premium, it brings you to premium check page and shows you the feature is "Migrate tweets to Bluesky":

The old premium check view used to determine exactly what features were required by loading account settings from the database (like, deleteLikes). But this is a new premium feature that isn't storing anything in the account settings, so I've introduced two new localStorage items: premiumCheckReason-${accountID} and premiumTasks-${accountID}.

If a user doesn't have premium, before redirecting to the premium check, it sets premiumCheckReason to migrateTweetsToBluesky and it sets premiumTasks to a list of tasks, which is just one right now ("Migrate tweets to Bluesky"):

    // Premium check
    if (await window.electron.getMode() == "open") {
        if (!await showQuestionOpenModePremiumFeature()) {
            return;
        }
    }
    // Otherwise, make sure the user is authenticated
    else {
        if (!props.userAuthenticated || !props.userPremium) {
            localStorage.setItem(`premiumCheckReason-${props.model.account.id}`, 'migrateTweetsToBluesky');
            localStorage.setItem(`premiumTasks-${props.model.account.id}`, JSON.stringify(['Migrate tweets to Bluesky']));
            emit('setState', XState.WizardCheckPremium);
            return;
        }
    }

When you're trying to delete your data, before redirecting the user to premium check, it now sets premiumCheckReason in localStorage to deleteData. And the premium check view uses this information to determine what features to display, and also what the back button should say and where it should go. So if you're trying to delete data with a bunch of premium features enabled, the premium check looks like this now, where the back button brings you to the delete review page:

Anyway, back to migrating to Bluesky: I envision people may want to pay for premium directly so they can move forward and migrate their tweets, so I want this flow to be flawless. After logging in (my account has already paid for premium) it shows this:

The button is "Migrate to Bluesky" in this case, but if I were doing this flow from the Delete from X page, then the button would bring me back to deletion options.

Once I'm signed in and I have premium, clicking "Start Migrating to Bluesky" will actually migrate to Bluesky.

Migration

As soon as you click the button, it migrates all of your tweets super fast. It gets all 58 of mine in a few seconds. Here's a screenshot I snagged.

When it's done, it tells you how many tweets it migrated and there's a link to load your Bluesky profile:

If there are any errors while migrating, it shows you the errors here too, which I'll get to in a second.

Over on Bluesky, everything should get migrated. Here's a video that was migrated:

Here's a tweet with multiple images and also a thread:

Here's a quoted tweet, quoting a a different X account:

The migrate to Bluesky feature supports the following:

• Posts are backdated
• The text of the tweet is updated to replace t.co links with actual URLs, and it adds facets to turn these URLs into actual links
• It handles self-replies, which keeps twitter threads intact when migrating them
• It handles self-quotes, and if you quote tweet someone else, it adds a website card
• It handles images and video
• It handles recordWithMedia -- which is a quote post that also includes media

After you migrate your tweets to Bluesky, there's now a button to delete them if you want (I used this for debugging):

That should delete all of the posts that were migrated. And when you browse your archive, all of the migrated tweets should now have a "migrated to Bluesky" link which links to the new Bluesky post.